\documentclass[a4paper,11pt,oneside]{report}
\usepackage[german]{hgb}	 % options: german, english
\usepackage[margin=3cm]{geometry}
\graphicspath{{images/}}   	% where are the EPS images?
\usepackage{hyperref}

%%%-----------------------------------------------------------------------------------------------
\begin{document}
%%%-----------------------------------------------------------------------------------------------

\author{Alexander Bohn \\
	     Manuel Djalili \\
	     Dominik Gruber \\
	     Manuel Mayrhofer \\
	     Philipp Naderer}
	     
\title{QSE-ASE-08 \\  
        Tenez \\
        Installationsleitfaden}

\date{Oktober 2009 - Januar 2010}

%%%-----------------------------------------------------------------------------------------------
\maketitle
%\tableofcontents
%%%-----------------------------------------------------------------------------------------------

%%%-----------------------------------------------------------------------------------------------
\chapter{Installationsleitfaden für Tenez (localhost Version)}
%%%-----------------------------------------------------------------------------------------------

\section{Benötigte Software}

\begin{tabular}{ l l }
	1. & Java 6 \\
	2. & Helma 1.7 \\
	3. & PostgreSQL 8.4 \\
\end{tabular}

\section{Helma Installation}

Download der aktuellen Helma 1.7 Version von \url{http://adele.helma.org/download/helma/}. Mit Stand 21. Januar 2010 ist der Release Candidate 3 aktuell. \\

Das ZIP an einen Ort eigener Wahl extrahieren. Die Skripte \emph{start.bat} bzw. \emph{start.sh} dienen zum Starten des Servers. Zuvor kann man in diesen noch den Port konfigurieren - Standard ist 8080 für HTTP. \\

Nun muss die Management Konsole aktiviert werden. Unter \url{http://localhost:8080/manage/makekey} lässt sich ein User mit Passwort anlegen. Die hier generierte Zeile muss in \emph{server.properties} im Helma Root Verzeichnis eingetragen werden. Nun ist die Management Konsole unter \url{http://localhost:8080/manage/main} erreichbar. Hier können \zB die einzelnen Applikationen neu gestartet oder ihr Cache geleert werden.


\section{Tenez Projekt auschecken}

Mittels einem SVN-Client eigener Wahl (\zB Versions, Eclipse mit Subclipse) das Projekt vom SVN Verzeichnis \emph{/trunk} in \emph{/<helma-root>/apps/tenez} auschecken. Die Daten zum Checkout finden sich unter \url{http://code.google.com/p/tenez/source/checkout}. \\

Demo-Video für den Checkout mit Subclipse: \url{http://tenez.at/blog/2009/11/source-code-auschecken}

\section{Helma Einstellungen}

Den Inhalt von \emph{/<tenez-root>/config/apps.properties.example} kopieren und den Inhalt von \emph{/<helma-root>/apps.properties} damit ersetzen. Das dient zum richtigen Mounten von Tenez.
\\ \\
In \emph{<helma-root>/lib/ext} müssen folgende Bibliotheken installiert werden:  \\ \\
\begin{tabular}{ | l | l | }
\hline
Name & Link \\
\hline
barbecue-1.5-beta1.jar & \url{http://barbecue.sourceforge.net}\\
barcode4j-2.0.jar & \url{http://barcode4j.sourceforge.net} \\
commons-beanutils-1.8.0.jar & \url{http://commons.apache.org/beanutils} \\
commons-collections-2.1.1.jar & \url{http://commons.apache.org/collections} \\
commons-digester-1.7.jar & \url{http://commons.apache.org/downloads/download\_digester.cgi} \\
commons-javaflow-20060411.jar & \url{http://tinyurl.com/yftzjqz} \\
commons-validator-1.3.1.jar & \url{http://commons.apache.org/validator} \\
groovy-all-1.5.5.jar & \url{http://groovy.codehaus.org/Download} \\
iText-2.1.0.jar & \url{http://sourceforge.net/projects/itext/files} \\
jakarta-oro-2.0.6.jar & \url{http://jakarta.apache.org/site/downloads/downloads_oro.cgi} \\
jasperreports-3.7.0.jar & \url{http://jasperforge.org/projects/jasperreports} \\
jdt-compiler-3.1.1.jar & \url{http://tinyurl.com/ygnjbqu} \\
jfreechart-1.0.12.jar & \url{http://www.jfree.org/jfreechart/mysql-connector-java-5.1.10-bin.jar} \\
postgresql-8.4-701.jdbc4.jar & \url{http://tinyurl.com/yhgupkh} \\
\hline
\end{tabular}

\section{Datenbank}

Eine PostgreSQL-Datenbank mit dem Namen \emph{tenez} erstellen, zu dem der Benutzer \emph{tenez\_prod} (Passwort: \emph{tenez\_prod}) vollen Zugang hat. \\

Anschließend mittels \emph{/<tenez-root>/config/database.sql} die erforderlichen Tabellen anlegen.

\section{Initialisierung}

Wenn der Helma- und PostgreSQL-Server laufen, muss die Init-Applikation unter \url{http://localhost:8080/init} aufgerufen werden um die Datenbank mit den notwendigen Basis-Daten zu füllen. Diese bestehen aus dem Systemadministrator-Zugang, Berechtigungen, einer Länder- und Städtedatenbank sowie unterstützten Währungen. \\

Nachdem die Init-Applikation ausgeführt wurde, muss entweder der Helma Server neu gestartet werden oder der Cache der Frontend- und Backend-Applikation über die Helma Management-Konsole geflusht werden. \\

\section{Betrieb}

Nun ist Tenez fertig installiert und unter \url{http://localhost:8080/admin} ist der Verwaltungsbereich zugänglich. Ein Login erfolgt mittels dem angelegten Benutzer \emph{tenezroot} mit Passwort \emph{tenezroot}. Sobald ein Club angelegt wurde, besitzt dieser ein Frontend, welches unter \url{http://localhost:8080/frontend/clubs/<clubname>} erreichbar ist.


%%%----------------------------------------------------------
\chapter{Versionsprotokoll}
%%%----------------------------------------------------------

\begin{tabular}{ l l l l}
	v1.0 & 21.01.2010 & Dominik Gruber & Strukturierung \\
	v0.2 & 17.01.2010 & Manuel Djalili & Installationsleitfaden update (lib/ext) \\
	v0.1 & 09.12.2009 & Manuel Djalili & Erste Version: Installationsleitfaden \\
\end{tabular}


%%%----------------------------------------------------------
\end{document}
%%%----------------------------------------------------------
